home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1993 November / JCSM Shareware Collection - 1993-11.iso / cl260 / study30j.lzh / INVOKE.DOC < prev    next >
Text File  |  1993-02-23  |  4KB  |  129 lines

  1.  
  2.  
  3.                           Bill McGinnis Software
  4.                               P. O. Box 2543
  5.                           Alexandria, VA  22301
  6.                                  U. S. A.
  7.  
  8.  
  9.  
  10.       METHODS OF INVOCATION BETWEEN STUDY HALL AND OTHER CAI SYSTEMS
  11.  
  12.          (This is version 1.0 of invoke.doc, released Feb., 1993)
  13.  
  14.                  NOTE:  This file is intended for CAI
  15.                  developers.  It assumes you already have
  16.                  a printed copy of instr.doc available.
  17.  
  18.  
  19.     STUDY HALL is designed to be highly compatible with other CAI
  20. development systems, both present systems and future.  In fact, because of
  21. its screen-oriented nature, where each screen has a name and number, STUDY
  22. HALL is probably easier to invoke than any other CAI system in the world.
  23.  
  24.     It is a simple matter to jump into and out of STUDY HALL tutorials at
  25. any point desired.  If you are already using another CAI development
  26. system, it is very easy to start using STUDY HALL subroutines, within your
  27. present CAI environment.  Here is how . . .
  28.  
  29.  
  30.                   INVOKING STUDY HALL FROM OTHER SYSTEMS
  31.  
  32.  
  33.     In general, to enter a STUDY HALL tutorial at a particular screen,
  34. this is the syntax of the DOS command:
  35.  
  36.                STUDY/filename/screen-name     or
  37.  
  38.                STUDY/filename/screen-number
  39.  
  40.  
  41.     Other CAI systems will each have their own particular command syntax,
  42. but in every case, the syntax shown above will be imbedded in the invoking
  43. command.  For example, a PC-CAI tutorial would use this command to invoke
  44. a STUDY HALL tutorial at a particular screen:
  45.  
  46.                @SHELL (*STUDY/filename/screen-name*)   or
  47.  
  48.                @SHELL (*STUDY/filename/screen-number*)
  49.  
  50.     This command causes a temporary exit from the PC-CAI tutorial while
  51. the STUDY HALL tutorial is being entered and run.  At the proper point,
  52. control is returned to the invoking tutorial with this STUDY HALL  control
  53. character:
  54.  
  55.                <* exit *>
  56.  
  57.  
  58.     This causes STUDY HALL and its tutorial to be erased from memory, amd
  59. control is returned to the invoking PC-CAI tutorial, at the point where it
  60. left off, just like a GOSUB in BASIC.
  61.  
  62.                                   page 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.     The <* exit *> control character can also be used in its conditional
  72. form, such as this:
  73.  
  74.                <* if score is less than 90 then exit *>  or
  75.  
  76.                <* if answer is cat then exit *>
  77.  
  78.  
  79.  
  80.                   INVOKING OTHER SYSTEMS FROM STUDY HALL
  81.  
  82.  
  83.     It also works the other way:  you can invoke another CAI development
  84. system from STUDY HALL, run it as a subroutine, then return to STUDY HALL
  85. at the next screen.
  86.  
  87.     If STUDY HALL is the invoking system, and another system is being
  88. invoked, then the STUDY HALL control character is:
  89.  
  90.                  <* doscommand xxx *>
  91.  
  92.      . . . where xxx is the DOS command needed to load and run the invoked
  93. tutorial. (In fact, xxx can be any legal MS/DOS command, for any purpose,
  94. not only for invoking other CAI systems.)
  95.  
  96.     For example, this is the STUDY HALL control character which would
  97. invoke a PC-CAI tutorial with a filename of bigdog:
  98.  
  99.                 <* doscommand CAI bigdog *>
  100.  
  101.  
  102.     At this time, there seems to be no way to enter a PC-CAI tutorial at a
  103. particular location.  You have to start at the beginning.
  104.  
  105.     The <* doscommand *> control character can also be used in its
  106. conditional form, such as this:
  107.  
  108.          <* if score is greater than 90 then doscommand CAI super *>  or
  109.  
  110.          <* if answer is not Donald Duck then doscommand CAI goofy *>
  111.  
  112.  
  113.     Each CAI system will have its own way of returning control to the
  114. invoking STUDY HALL tutorial.  In the case of PC-CAI, the command would
  115. be:
  116.  
  117.                 @STOP SYSTEM
  118.  
  119.     This command erases PC-CAI and its tutorial from memory and returns
  120. control to the invoking STUDY HALL tutorial, at its next screen.
  121.  
  122.     For details about PC-CAI, write to P. O. Box 1169, Cedar Hill, Texas,
  123. 75104, U. S. A.
  124.  
  125.     For details about STUDY HALL control characters, please see the file
  126. named instr.doc, on the STUDY HALL release disk.
  127.  
  128.                                    ###
  129.